home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 14 / Mac Magazin and MacEasy Magazine CD - Issue 14.iso / Wissenschaft & Technik / Tools Plus 2.6.1 Evaluation Kit / Tools Plus 2.6.1 / User Manual / Update History / Read Me! 2.5.2 -> 2.5.3 changes < prev    next >
Text File  |  1994-12-12  |  4KB  |  61 lines
  1. Tools Plus Changes: 2.5.2 to 2.5.3
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. Display this document in Geneva 12pt.
  4.  
  5. You need to read this document if:
  6.    √ You are upgrading from an older version of Tools Plus. If you
  7.        are upgrading from a version older than 2.5.3, read all other
  8.        applicable change documents first.
  9.    √ If you have purchased Tools Plus 2.5.3 and it arrived with a
  10.        Tools Plus 2.5 User Manual. Double-bullets (••) denote changes
  11.        that are NOT in the printed manual.
  12.  
  13.  
  14.                                       * * * W A R N I N G * * *
  15.  
  16.           THIS UPDATE INCLUDES REVISIONS THAT MAY REQUIRE YOU
  17.           TO CHANGE PARTS OF YOUR EXISTING APPLICATION(S). 
  18.           PLEASE READ CAREFULLY.
  19.  
  20.  
  21. Tools Plus 2.5.3, released in January 1995, includes the following changes implemented since the previous version, 2.5.2:
  22.  
  23.   • Tools Plus 2.5.3 contains a new set of libraries and files.
  24.      Replace your existing Tools Plus files with the new ones included
  25.      in this update. Delete all your old copies of the Tools Plus
  26.      libraries and related files (C header, Pascal interface etc.)
  27.  
  28.   • If two or more non-standard windows are open (tool bar and/or
  29.      floating palettes) with no standard windows, they now behave
  30.      correctly.
  31.  
  32.   • SelectButton now works correctly on buttons that use custom
  33.      fonts (it used to display the system font).
  34.  
  35.   • Pasting text into a multiple-line editing field used to sometimes
  36.      result in a “ghost caret” (second insertion point) or obsolete text
  37.      would sometimes be visible below the last line of text. This
  38.      has been corrected.
  39.  
  40.   • In low memory situations, or in applications with numerous
  41.      unrelocatable heap objects (created via pointer or using locked
  42.      handles), editing fields now make better use of all memory
  43.      available throughout the application’s heap.
  44.  
  45. •• Your application can now respond to the doPreRefresh _and_
  46.      doRefresh event without having to preserve the window’s update
  47.      region. Your application can also ignore both events without
  48.      ill effects.
  49.  
  50.  
  51.  
  52. ------------------------------------------------------------
  53. •• Enhanced doPreRefresh/doRefresh logic
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55.   Your application can now make use of the doPreRefresh and/or doRefresh events (or ignore them both) without having to store and restore the affected window’s update region. The following technical information is only for those who are interested in the mechanics of how this is accomplished.
  56.  
  57.   When your application receives a doPreRefresh event, it can either use the event to draw objects that appear behind Tools Plus objects (such as a background picture that is drawn behind picture buttons), or your application can ignore the event.
  58.   The next time your application calls PollSystem, Tools Plus reapplies the window’s original update region (in case it was cleared by a BeginUpdate/EndUpdate structure responding to the doPreRefresh event), then it draws its _own_ objects (buttons, scroll bars, editing fields, picture buttons, etc.) within the window’s update region.
  59.   Tools Plus then generates a doRefresh event. At this point, the window’s update region is modified to exclude Tools Plus’s objects.   When your application receives a doRefresh event, it can either use the event to update objects that are drawn after Tools Plus objects (such as static text or pictures), or your application can ignore the event.
  60.   The next time your application calls PollSystem, Tools Plus clears the window’s update region (if your application has not already done so in the doRefresh cycle).
  61.